home *** CD-ROM | disk | FTP | other *** search
/ Mac Format 1996 April / MacFormat CD Edition MF36 (April 1996).iso / Shareware City / Developers / Tools Plus - GUI⁄Event libs / Tools Plus 2.6.1a Evaluat'n Kit / Tools Plus 2.6.1a / User Manual / 19-Other Macintosh Features < prev    next >
INI File  |  1994-12-12  |  4KB  |  80 lines
  1. [Display using Monaco 9]
  2.  
  3.  
  4. 19  Other Macintosh Features
  5. ````````````````````````````
  6.  
  7.   This section of the user manual deals with parts of the Macintosh toolbox that you may or may not decide to incorporate into your application.  They are:
  8.     • Alerts
  9.     • Dialogs
  10.     • Custom Controls
  11.     • Lists
  12.  
  13.   Except for Custom Controls, Tools Plus provides viable alternatives to the Macintosh’s native toolbox routines.  This chapter details those alternatives.
  14.  
  15.  
  16.  
  17.  
  18.  
  19. Alerts
  20. ``````
  21.   Macintosh alert boxes, as described in chapter 13 (Dialog Manager) of Inside Macintosh Volume I, can be used with Tools Plus with no ill effects.  Because alerts are modal windows, and the Macintosh’s Dialog Manager takes care of creating and maintaining the alert’s window as well as the objects in the window, no conflicts will arise.
  22.  
  23.   You should consider using Tools Plus’s AlertBox routine, which gives you several advantages that regular alert boxes don’t:
  24.  
  25. • Because you don’t have to use Apple’s Resource Editor (ResEdit), you
  26.   can create alert boxes as the need for them arises, and you don’t have
  27.   to leave your development environment to do it.
  28.  
  29. • Your application’s source code will be more readable because the icon,
  30.   text, and button configuration will all be stated in the same line of
  31.   source code.
  32.  
  33. • The text in the dynamic alert box is self-aligning to make the text
  34.   look aesthetically pleasing.  You have to take care of this yourself
  35.   when designing alert boxes as resources.
  36.  
  37. • Your alert boxes are always centered on the main monitor regardless of
  38.   the Macintosh your application is running on or the System version
  39.   it’s running.  Standard Macintosh alerts won’t.
  40.  
  41.  
  42.  
  43.  
  44.  
  45. Dialogs
  46. ```````
  47.   Macintosh dialog boxes, as described in chapter 13 (Dialog Manager) of Inside Macintosh Volume I, can be used with Tools Plus.  These dialogs must be modal.
  48.  
  49.   Several problems will arise if a modeless dialog box is used, the most noticeable of which is Tools Plus’s inability to translate the Toolbox Event Manager’s event into a Tools Plus event.  Events pertaining to modeless dialogs are ignored and are not reported to your application.
  50.  
  51.   Considering how easy Tools Plus’s windows are to create and use, why not use them instead of dialogs?
  52.  
  53.  
  54.  
  55.  
  56.  
  57. Custom Controls
  58. ```````````````
  59.   Custom controls can be created by programmers and used with Tools Plus windows.
  60.  
  61.   The only requirement is that bit 31 of the control’s reference value (contrlRfCon field) is set to “1”.  This can be done by using a binary AND operation with the hex value $80000000.  All interaction with the custom control must be handled by your application.  When a mouse-down event occurs in any custom control, the doClickControl event will report this and hand the Toolbox Event Manager’s event to your application.
  62.  
  63.   Exercise extreme caution when using custom controls because your application will likely be acquiring events by using GetNextEvent, which “steals” events from the event queue and prevents Tools Plus from processing them.
  64.  
  65.   See the chapter on “Special Routines” in this manual.  It will explain the caution that needs to be exercised when using some of the Macintosh’s toolbox routines.
  66.  
  67.  
  68.  
  69.  
  70.  
  71. Lists
  72. `````
  73.   The List Manager routines, as described in chapter 30 (List Manager) of Inside Macintosh Volume IV, may be incorporated into your application to handle sophisticated or custom lists.  Tools Plus requires that you flag any controls used by the list (right and/or bottom stroll bar, for example) as belonging to your application.  To do this, set bit 31 of the control’s reference value (contrlRfCon field) to “1”.  This can be done by using a binary AND operation with the hex value $80000000.  Your application must handle all events pertaining to the list and its controls.
  74.  
  75.   Exercise extreme caution when using the List Manager because your application will likely be acquiring events by using GetNextEvent, which “steals” events from the event queue and prevents Tools Plus from processing them.
  76.  
  77.   See the chapter on “Special Routines” in this manual.  It will explain the caution that needs to be exercised when using some of the Macintosh’s toolbox routines.
  78.  
  79.   In most situations, Tools Plus’s lists will fulfill your application’s needs for creating and maintaining a list.  Considering how easy Tools Plus’s lists are to create and use, why not use them instead of the Macintosh’s List Manager?
  80.